🚀 Windows 安裝 uv 的主要方法

在 Windows 上安裝 uv（超高速 Python 套件管理與虛擬環境工具） 的方式其實非常簡單，而且有幾種不同方法可以選擇。下面整理成清楚、可操作的指南，並附上你可能會在意的細節與差異。

🟦 方法 1：使用官方 PowerShell 安裝腳本（最推薦）

這是 uv 官方建議 的方式，速度快、設定完整。

步驟

  1. 開啟 PowerShell（建議以系統管理員執行）
  2. 執行以下指令：
irm https://astral.sh/uv/install.ps1 | iex

📌 來源：官方文件

驗證安裝

uv --version

🟦 方法 2：使用 pip 安裝（如果你已經有 Python）

如果你已經有 Python 並且想用 pip 安裝：

pip install uv

📌 來源：官方文件

注意：若 pip 無法找到 wheel，uv 會從 source 編譯，需要 Rust toolchain。

🟦 方法 3：使用 WinGet 安裝

如果你有 Windows 10/11 內建的 WinGet：

winget install --id=astral-sh.uv -e

📌 來源：官方文件

🟦 方法 4：使用 Scoop 安裝

如果你使用 Scoop 套件管理器：

scoop install main/uv

📌 來源：官方文件

🧪 安裝後快速測試 uv

建立虛擬環境

uv venv --python 3.12

啟用虛擬環境

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.venv\Scripts\activate

📌 來源：Windows 教學

🧭 什麼時候該用哪種方式？

方法 適合情況 優點 缺點
PowerShell 官方腳本 想要最快、最官方的方式 自動設定 PATH、免 Python 需允許執行腳本
pip 已有 Python 且想保持環境一致 安裝簡單 可能需要 Rust 編譯
WinGet 習慣用 Windows 套件管理 更新方便 需 WinGet
Scoop 使用 Scoop 管理工具 安裝/更新一致 需先安裝 Scoop

📚 來源

Installation | uv - Astral
GitHub - uv Windows 教學

Interactive Graph
Table Of Contents
🚀 Windows 安裝 uv 的主要方法
🟦 方法 1：使用官方 PowerShell 安裝腳本（最推薦）
步驟
驗證安裝
🟦 方法 2：使用 pip 安裝（如果你已經有 Python）
🟦 方法 3：使用 WinGet 安裝
🟦 方法 4：使用 Scoop 安裝
🧪 安裝後快速測試 uv
建立虛擬環境
啟用虛擬環境
🧭 什麼時候該用哪種方式？
📚 來源